home *** CD-ROM | disk | FTP | other *** search
/ Dream 52 / Amiga_Dream_52.iso / Amiga / Applications / Musique / ays-t23d.lha / BoNuS @ thx.home.ml.org / SEA-THXR.LHA / thxripper.readme < prev   
Text File  |  1998-03-09  |  11KB  |  339 lines
  1. Short:    THX-Module ripper
  2. Author:   Kσre Johansen <kaarej@barentsnett.no>
  3. Uploader: Kσre Johansen <kaarej@barentsnett.no>
  4. Version:  3.1
  5. Type:     Mus/Misc
  6. Requires: OS2.0+ , Reqtools
  7. Replaces: Mus/Misc/thxripper.lha
  8.  
  9.     Say..
  10.         -----
  11.  
  12.     THXRipper is no longer an Oops! production or something, or/and
  13.     has never been.. THXRipper has become a Seasons Production.. :)
  14.  
  15.     This small ripper rips THX modules, by searching in files.
  16.     It supports XFD-crunchers, and uses Abyss's replayer routine.
  17.     THX is NOW using a GUI (Gadtools), so.. It will be easier
  18.     playing modules, hunting and so on! :) THX-Ripper has now
  19.         locale support, just change the LANGUAGE tooltype in the
  20.     icon for other languages..
  21.  
  22.     The THX Music system was implentet by Dexter/Abyss..
  23.  
  24.     THXRipper is for the second time included in the release package
  25.     of The THX-Music-System v2.x, hopefully it will be included everytime
  26.     there is a new archieve of THX to release.. Anyway, have fun.. 
  27.  
  28.     PLEASE...
  29.         ---------
  30.  
  31.     It would be nice if ALL of you that uses THXRipper could EMAIL
  32.         me, so I can see how many that uses THXRipper. This is just for
  33.         future development of THXRipper (EMAIL me ONCE not more or less)..
  34.     If you have mailed me before, then mail me again..
  35.  
  36.     Thanks in advance.. 
  37.  
  38.     Usage
  39.         -----
  40.  
  41.     If run from SHELL then the DEFAULT (english) language will be
  42.     used.. Run if from WB! :) (I use ToolsDaemon)
  43.  
  44.     Default settings are:
  45.  
  46.     AUTOPLAY = NO        (I think its the default)..
  47.     MOUSE    = 1         (left mousebutton)
  48.     LANGUAGE = English   (Locale)
  49.     MEM     = 0         (0 = Fast MEM)
  50.  
  51.  
  52.     Menus
  53.     -----
  54.  
  55.     Snapshot window - This function will snap the current window
  56.               position, and save it in env(arc):
  57.                           It will also save the path for the filerequester
  58.                           aswell.
  59.  
  60.               Next time you open THXRipper, THXRipper will
  61.               open on the location you snapshot it at..
  62.  
  63.  
  64.     Iconify        - With this menu, you can iconify the window,
  65.               and let THXRipper play in the background without
  66.               any annoying play/THXRipper window...
  67.  
  68.     Set Languages    - I have added this as a feature in v3.0, so that
  69.               users don't have to edit the icon to change
  70.               to another language.. The language choosen will
  71.               not be saved in the icon (yet)..
  72.  
  73.     Quit        - What do ya know! :)
  74.  
  75.  
  76.     Available Tooltypes
  77.         -------------------
  78.  
  79.     Available Tooltypes commands:
  80.  
  81.     LANGUAGE
  82.     MOUSE
  83.     MEM
  84.     AUTOPLAY
  85.  
  86.         -------------------------------------------------------------------
  87.  
  88.     LANGUAGE=language (see available languages (in this Archieve) list )
  89.  
  90.         Is used to change the language to another country language, e.g:
  91.  
  92.         LANGUAGE=norsk
  93.  
  94.     MOUSE={1-3}
  95.  
  96.     This option is ONLY available when playing a module. This option
  97.     will let you choose what mousebutton needed to click to end/or stop
  98.     a module playing. The value can be from 1 to 3, meaning:
  99.  
  100.     1 = Left mousebutton
  101.     2 = Right mousebutton
  102.     3 = Both mousebuttons
  103.  
  104.     Any other values will confuse THXRipper.. So, don't use any other..
  105.  
  106.     MEM={0-1}
  107.  
  108.     This option will load all SFX to the memory location that you
  109.     have set, FAST is default (0)
  110.  
  111.     0=FAST RAM
  112.     1=CHIP RAM
  113.  
  114.     AUTOPLAY=This tooltype option will make THXRipper autoplay loaded
  115.     THX and PT modules without pressing the "PLAY" button.. 
  116.     Default=NO
  117.  
  118.     YES=Will autoplay loaded modules
  119.      NO=Will not autoplay loaded modules
  120.  
  121.     Other Languages
  122.         ---------------
  123.  
  124.     If you want to make other languages for THXRipper, then go ahead..
  125.     But, please send them to me, so that I can include them in the
  126.         next release of THXRipper..
  127.  
  128.     I have included ALL *.ct files so that you can make other
  129.         languages.. If you don't understand the HOTKEY feature in the
  130.     *.CT file, leave it to me ! :)
  131.  
  132.         If you create new languages, send the *.CT file to me by EMAIL..
  133.  
  134.     Languages available
  135.     -------------------
  136.  
  137.     Languages available in this version:
  138.  
  139.     * Nederlands
  140.     * Norwegian (Norsk)
  141.     * English (Default)
  142.     * Svenska
  143.     * Suomi
  144.     * polski
  145.  
  146.     Copyright
  147.     ---------
  148.  
  149.     THXRipper is Copyrighted by me Dr. Ice SEA (Kσre Johansen)
  150.     in 1997-98, but is released as freeware/PD.. This archieve CAN NOT
  151.     be sold for any profit, except from diskcharge and mail expences..
  152.  
  153.     Language
  154.     --------
  155.  
  156.     This module ripper is coded by using Amiga E (The most powerful
  157.     languange ever ;))..
  158.  
  159.     Thanks to
  160.         ---------
  161.  
  162.     Wouter        - For making AmigaE, and for developing it..
  163.     Dexter/Abyss    - For the replayer bin file, and the ASM example..
  164.     Kyzer/CSG    - For making the Amiga E module (THX)
  165.     Kenneth Jonsson - THXRipper should now save the instrument names
  166.               aswell :)
  167.     OPS! members    - For beta testing
  168.     Tycoon/OPS    - For making the Nederlands catalog..
  169.     Straw/OPS    - For helping Tycoon! :)
  170.     Wivern/OPS    - For making the swedish catalog (svenska)
  171.     Antti Pyykk÷    - For making the Finnish catalog (Suomi)..
  172.  
  173.         Greetings to
  174.         ------------
  175.  
  176.     All SEA members
  177.     All Oops! members
  178.     Weird One
  179.     Dexter/Abyss
  180.     Kyzer/CSG
  181.     Lizard/TBL
  182.     Daiz'l / Mystic
  183.  
  184.     And all the cool dudes I know on the IRC, and everybody else
  185.     in the scene..
  186.  
  187.     (I'm now known as: dRICE^SEA (On the IRC))
  188.  
  189.     History
  190.     -------
  191.  
  192.     v3.1
  193.     - Released with THX-Music system by Dexter/ABYSS..
  194.     - Added RND button in the play-window
  195.     - Improved SONG name requester (play window, shows song # aswell)
  196.     - Made shortcuts for PREV and NEXT song in play window..
  197.     - Releasing THXPlay.e src for the first time, cause I will not be
  198.       coding any more at it.. Enjoy.. Well... 
  199.     - Added menu (ICONIFY) to the player-window.. 
  200.     - Fixed some minor DISABLE gadget problems
  201.  
  202.     v3.0
  203.     - Added Multiselection of files when/for playing modules (THX/PT)
  204.     - Added previous and next button (< and >) in the play-requester..
  205.     - Added text window that shows what tune is playing (Play-requester).
  206.     - The original .CT (Language) file is released for the first time..
  207.     - The menus are not added to the PLAY routines, but.. RightAmiga+I
  208.       (ICONIFY) works.. :)
  209.     - Added new MENU "SET LANGUAGE", this will set THXRipper to use
  210.       another language (This will not be saved yet).. Select one of
  211.       the files in the PROGDIR:Cats/ file.. 
  212.     - THXRipper sometimes crashed when using CHIP-mem..
  213.     - THXRipper should now be kinda faster! :) Re-Wrote some of the code
  214.     - Fixed a bug or two.. :)
  215.     - Added a Play window..
  216.     - Added BN_STOP (this is used by the Play window "STOP" button)
  217.     - Added HOT_T   (this is used by the play window "STOP" button)
  218.           as underscore..
  219.     - Removed TXT_MOUSE(2 and 3) from all local files
  220.     - Added TXT_CATALOGAUTHOR to the local support, this options lets
  221.       the author of the catalog sign his signature/name.. e.g
  222.  
  223.     TXT_CATALOGAUTHOR
  224.     This catalog was translated by me, and nobody else! :).. \nAnd...
  225.     ; Comment line.. 
  226.  
  227.     Notice that you can use \n as a return code within these cataloges
  228.     for longer messages.. e.g
  229.  
  230.     This\nwas\na\nbeatiful\nday!!! Which will be in about window:
  231.  
  232.     This <return>
  233.     was  <return>
  234.     a    <return> and so on! :).. 
  235.  
  236.     - Added QUIT to the menu
  237.     - THXRipper now precalcs before continuing, this is because when
  238.       playing modules; you don't need to wait before it plays (THX)
  239.     - Recompiled THXRipper with the 4th THX EMODULE..
  240.     - Added new tooltype; AUTOPLAY..
  241.     
  242.  
  243.     v2.8
  244.     - v2.7 was never released caused by some code mistakes by Dexter..
  245.     - Recompiled the v2.7 version with the new Amiga E module by
  246.       Kyzer/CSG. And it works again..
  247.     - Added Suomi catalog file to the archive, done/written by
  248.       Antti Pyykk÷, pyksy@pohjankartano.edu.ouka.fi..
  249.     - Some minor bugs removed
  250.     - Added 000 and 020 version of THXRipper in the archive...
  251.  
  252.     v2.7
  253.     - Used Dexter's Amiga E module, and it works (atlast)..
  254.     - Added FILENAME: (in locale ofcoz) when selecting a THX-Module.
  255.     - Rewrote THXPlay src. THXPlay exits by pressing CTRL-C now,
  256.       THXPlay also uses the FADE up and down routine..
  257.     - Added a new Tooltype option, MEM={0 OR 1} , Requested by
  258.       EagleGhost on the IRC (Channel #Oops!)
  259.     - THXRipper is now using the THX CIA INTERRUPT..
  260.  
  261.     v2.6
  262.     - THXripper v2.6 is released with the THX-sound system by
  263.       Dexter/Abyss.. 
  264.     - Fixed some minor mistakes
  265.     - Recoded some small routines to maintain speed! :)
  266.     - Rewrote the ENV(ARC): routine
  267.     - Implented PATH-save when snapshoting the window
  268.     - Re-compiled the THX-replayer v2.00 in THXRipper
  269.     - The revision string has been changed from:
  270.       Revision: 0   TO   Revision: 0 (THX v1.x)
  271.                              Revision: 1 (THX v2.x)
  272.       This means that the module you have found is a THX-system v1.x
  273.       Module or v2.x module..
  274.  
  275.     v2.5
  276.     - Added a CLI THX-player
  277.     - THXRipper didn't rip ALL the modules in a file. This bug was
  278.       reported by Dexter/Abyss.. The problem is caused by me, cause
  279.       I didn't set the search value to the location the last module
  280.       was found on, so we jumped over it.. This should be fixed..
  281.     - THXRipper should now remove trashy THX-Modules while searching,
  282.       so we get ALL the REAL modules, and not the Trashy ones. :)
  283.     - Added filename aswell to show when a module was found.. If this
  284.       is a trashy one, then it AIN'T no THX-module..
  285.  
  286.         v2.4 MAJOR UPDATE
  287.     - Added menu support (Well... Some :) ..)
  288.         - Added locale support (English=default)..
  289.       To change the language, change, or disable the LANGUAGE tooltype
  290.           in the icon..
  291.         - When cancel a found module, THXRipper disabled all the gadgets,
  292.           fixed
  293.         - Added a file requester when saving a module aswell..
  294.         - Added a "Sample"-button, witch display's all samples available in a
  295.           requester (only THX-modules)...
  296.         - Added a filechecker that checks for existens of a file, if a file
  297.           exists, THXRipper will not overwrite it if you doesn't want to! :)
  298.         - Added hotkey/underscore support..
  299.         - Added support for straight THX-Module loading, THXRipper let you
  300.           load a THX-module, and play it.. :)
  301.         - Fixed a small bug when getting to long texts (again)..
  302.         - Added player routine for Protracker modules (just for fun), just
  303.       load them as usually and press the play button..
  304.         - About is replaced with an about-requester, instead of print text..
  305.         - Fixed a small GFX-bug when using multiscan/productivity screenmode
  306.  
  307.     v2.1
  308.     - THXRipper didn't recalculate the sample names, thanks to
  309.       Kenneth Jonsson (Daiz'l / Mystic) for reporting this bug..
  310.     - Fixed a small bug when saving
  311.     - Added version ID (Again.. Forgot to include in v2.0..)
  312.  
  313.     v2.0
  314.     - Added a new check; If samples bigger than 63,
  315.       then the found THX module would be stamped as: BAD THX format..
  316.     - Added GUI
  317.     - Rewrote 70% of the code
  318.     - Added reqtools
  319.     - Added a faster search routine
  320.     + alot more..
  321.  
  322.     v1.1
  323.     - Added an ID to reconize the ripper itself ($ID: IDX)
  324.     - When saving found thx, THXRipper will auto add comment to this
  325.           file..
  326.     - Added Cia THX-Player to play found THX modules in files, please
  327.           notice that this routine is not playing on interrupt, it means
  328.           that you should let the system be, until you are tired of listning
  329.           to the THX-module...
  330.     - Removed AmigaE src from the archieve
  331.  
  332.     v0.1
  333.     - First public release
  334.  
  335.     Contact
  336.     -------
  337.     EMAIL : kaarej@barentsnett.no
  338.     BBS   : +47-78 47 10 42 / Key Stroke (Norway)
  339.